home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 028a / showdupe.zip / SHOWDUPE.DOC < prev   
Text File  |  1992-01-23  |  10KB  |  209 lines
  1.  
  2. SHOWDUPE.EXE   Version 1.0
  3.  
  4. Richard Hale Shaw                      February 25, 1992 (Utilities)
  5.  
  6.  
  7. SHOWDUPE finds all duplicate files on one or more hard disk drives,
  8. organizes them, displays them in a list box, and lets you interactively
  9. view, compare, select, and delete them. 
  10.  
  11. USING SHOWDUPE:
  12.  
  13. The syntax for SHOWDUPE is
  14.                               SHOWDUPE <d:\path> [d:\path]
  15.  
  16. where d: is the drive and \path is the path to the directory in which
  17. SHOWDUPE should begin to search. SHOWDUPE will recursively search each
  18. directory and all of its subdirectories. If you don't specify at least
  19. a drive on the command line, SHOWDUPE will default to the Search
  20. Directories entry in SHOWDUPE.INI, its configuration file.
  21.  
  22.      As the syntax indicates, you can specify more than one search
  23. drive and path on the command line. For example,
  24.  
  25. SHOWDUPE c:\ d:\olddos
  26.  
  27. There's no limit to the number of drives or directories you can specify
  28. on the command line. The total number of files SHOWDUPE can scan is
  29. limited only by the amount of conventional memory you have available;
  30. I've used it to scan over 7,000 files on a 200MB hard drive without
  31. any problems.
  32.  
  33.      Before you run SHOWDUPE, make sure SHOWDUPE.EXE and SHOWDUPE.INI
  34. are both in the current directory, or in a directory that is on your
  35. path. Once you execute the program, SHOWDUPE displays a window that
  36. lists all the files in the designated directories as it scans them.
  37. It then displays a window that lists your duplicate files.
  38.  
  39.      After it has found all the duplicate files, SHOWDUPE builds two
  40. tables, DUPES.IDX and DUPES.DAT, which it puts in the same directory
  41. as SHOWDUPE.EXE and SHOWDUPE.INI. Once it has created these files,
  42. the program won't attempt to create them again unless you delete them.
  43.  
  44.      DUPES.IDX contains a sorted list of the filenames; DUPES.DAT
  45. contains date, time, size, and directory pathname information. All this
  46. information could have been stored in a single file, but then when the
  47. filenames were sorted, SHOWDUPE would have to load all this information
  48. into memory when, in fact, it only needs the filenames. 
  49.  
  50.      The menu bar at the bottom of the screen lists the various commands
  51. for operating SHOWDUPE. In addition to using the arrow keys to navigate
  52. the listing of duplicate filenames, you can use Home and End go to the
  53. top and bottom, and PgUp and PgDn to jump through a screenful of
  54. filenames at a time. As you move the highlight bar through the list,
  55. the full path for the highlighted file appears in the Path window near
  56. the top of the screen.
  57.  
  58.       When you are ready to delete a duplicate file, scroll to that
  59. filename and press the Del key. SHOWDUPE will delete the file and gray
  60. its entry in the list box.
  61.  
  62.      You can tag multiple files by moving the highlight bar to each
  63. filename and pressing the Spacebar. SHOWDUPE will change the color of
  64. every entry that is tagged for deletion. If you change your mind and
  65. wish to untag a file, move the highlight bar to that entry and hit
  66. the Spacebar again; it will act as a toggle, and the color of the
  67. entry will return to normal. Once you have tagged all the files you
  68. want to delete, press F7 (Purge) to delete all the tagged files
  69. simultaneously.
  70.  
  71.      You can view a file with a separate file-viewing utility such as
  72. SMOOTH.COM (Michael Mefford's file viewer, which appeared in the
  73. Utilities column, February 14, 1989). SMOOTH scrolls a file on-screen.
  74. If you have a copy in a directory on your path, before deleting a file,
  75. highlight the filename and press Enter: SHOWDUPE will invoke SMOOTH and
  76. let you view the file. If you don't have SMOOTH.COM, you can download
  77. it from SOFTLIB, or Library 2 of the UtilForum on PC MagNet.
  78.  
  79.      While SHOWDUPE uses SMOOTH as its default file viewer, you can
  80. use an alternate file viewer if you prefer, such as Vern Buerg's LIST.
  81. Just modify the Viewer= entry in SHOWDUPE.INI. This initialization
  82. file lets you customize a number of SHOWDUPE's settings.
  83.  
  84.      While SHOWDUPE's list box may indicate that two files have the
  85. same name, date, time and size, they still might not be identical.
  86. How can you be sure they're really different? SHOWDUPE lets you
  87. perform a simple byte-by-byte comparison. Highlight the first filename,
  88. press F10, highlight the second filename, and press F10 again. SHOWDUPE
  89. will compare the contents of the two files and display a message telling
  90. you whether they are identical or not. 
  91.  
  92.      When you delete a file with SHOWDUPE, it does not disappear from
  93. the list box but simply appears grayed out. Therefore, after you've
  94. deleted a large number of duplicate files, you may wish to rebuild the
  95. .IDX and .DAT tables. Searching through a long list of files that have
  96. already been deleted isn't efficient. Select F9 (Build) and SHOWDUPE
  97. will rebuild the tables and update the list box.
  98.  
  99.      The Build command can also come in handy if you started deleting
  100. files with SHOWDUPE but didn't finish the task. When you run SHOWDUPE
  101. at a later date, it will redisplay the listing of duplicates exactly
  102. as you left it. However, it will not account for any new files you've
  103. created, new program files you may have loaded that may have created
  104. duplicates, or files you've deleted since the last time you ran
  105. SHOWDUPE. Hit F9 and SHOWDUPE will rebuild the tables, finding any new
  106. duplicates. To abort the table-building process, press any key.
  107.  
  108.      At any time, you can press Ctrl-Enter to shell out to DOS from
  109. SHOWDUPE. Simply type Exit to return.
  110.  
  111.  
  112. CONFIGURING SHOWDUPE:
  113.  
  114. With the increasing popularity of Microsoft Windows, it seems like
  115. almost every tips column in every magazine describes changes you can
  116. make to WIN.INI file. Initialization files are useful to DOS programs,
  117. too: You might have noticed that a number of applications, including
  118. the Norton products, use .INI files to store program settings.
  119.  
  120.      Initialization files are incredibly convenient, because you don't
  121. have to patch the program or own the source code to change the
  122. application. But they can be difficult to use. Some .INI files, like
  123. that of The Norton Commander, are largely binary; others, like Windows'
  124. WIN.INI, are not much more comprehensible. After all, who can remember
  125. what color setting 113 represents?
  126.  
  127.      I wanted to ensure that SHOWDUPE's initialization file, SHOWDUPE.INI
  128. would be easy to configure and understand. You can edit SHOWDUPE.INI
  129. with a simple text editor; you can use plain English words to indicate
  130. settings (for example, the word BLUE designates that color). SHOWDUPE.INI
  131. can contain settings and values in upper- or lower-case letters, or both.
  132. As with most .INI files, you can comment out a line by placing a
  133. semicolon (;) in front of it and add comments to a line by prefacing
  134. the comment with a semicolon. Whenever the program encounters a
  135. semicolon, it ignores that character and the rest of the line. Note
  136. that if a line is repeated, the second occurrence will take effect.
  137. For example if you have ScreenBackGround=BLUE and then
  138. ScreenBackGround=RED,  the background will be red.
  139.  
  140.      SHOWDUPE.INI lets you configure SHOWDUPE's screen colors, desktop
  141. colors, and window colors. You can also specify whether the program runs
  142. in 43- or 50-line mode on an EGA or VGA system, or uses the default
  143. screen mode. You can specify an alternate file viewer as well as name
  144. default search directories. 
  145.  
  146. THE COLOR SETTINGS
  147. SHOWDUPE.INI's settings have the form name=value, where name designates
  148. the name of a setting and value is the value of that setting. Thus
  149.  
  150. DeskTopBackGround=LIGHTGRAY
  151.  
  152. specifies the LIGHTGRAY color for the DeskTopBackGround setting. This
  153. is true for all settings in SHOWDUPE.INI.
  154.  
  155.      You can specify BLACK, BLUE, GREEN, CYAN, RED, MAGENTA, BROWN, or
  156. LIGHTGRAY for foreground and background color settings. You can also
  157. use DARKGRAY, LIGHTBLUE, LIGHTGREEN, LIGHTCYAN, LIGHTRED, LIGHTMAGENTA,
  158. LIGHTYELLOW, and WHITE for any foreground setting. (Theoretically, you
  159. can also use these colors for background settings, but they cause the
  160. background to blink.)
  161.  
  162.      The six color settings are: ScreenBackGround, ScreenForeGround,
  163. DeskTopBackGround, DeskTopForeGround, WindowBackGround and
  164. WindowForeGround. ScreenBackGround and ScreenForeGround control the
  165. color of the title bar and status lines at the top and bottom of the
  166. screen. The DeskTop settings control the colors of the desktop that
  167. appears under the windows, and the Window settings control the window
  168. colors.
  169.  
  170. OTHER SETTINGS
  171. The ScreenMode setting specifies whether the program runs in 43- or
  172. 50-line mode on an EGA or VGA system. If you don't have such a system,
  173. or just want SHOWDUPE to use the default video mode, set ScreenMode to
  174. DEFAULT:
  175.  
  176. ScreenMode=DEFAULT
  177.  
  178. To force SHOWDUPE into EGA or VGA mode on such a system, set ScreenMode
  179. to EGAVGA as follows (the setting is ignored on other systems):
  180.  
  181. ScreenMode=EGAVGA
  182.  
  183. Another setting, Viewer=, lets you override the default file viewer,
  184. SMOOTH.COM, if you don't have SMOOTH.COM or prefer another file viewer.
  185. I've used this setting to load an editor like BRIEF or PC Magazine's
  186. TED.COM. Just specify the name of the program:
  187.  
  188. Viewer=TED.COM
  189.  
  190. You don't need to specify the directory that the program resides in, as
  191. long as the program is in a directory in your PATH.
  192.  
  193.      Finally, the SearchDirectories setting lets you specify the
  194. default search directories for building duplicate file tables.
  195. Internally, SHOWDUPE defines this setting as NULL. You can override
  196. it by specifying one or more search directories. For example 
  197.  
  198. SearchDirectories=c:\bin d:\bin
  199.  
  200. If you specify search directories on the command line, they will
  201. override the settings found in SHOWDUPE.INI. This lets you maintain a
  202. set of default search directories in SHOWDUPE.INI, but you can change
  203. them at any time via command line arguments.
  204.  
  205.      In short, SHOWDUPE.INI makes SHOWDUPE far more flexible and fun
  206. to use.
  207.  
  208.  
  209. Richard Hale Shaw is a contributing editor of PC Magazine.